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PREFACE 


The information contained herein is summarized from OSlVS2 MVS Operator's 
Library: JESS Commands, GC23-0008, OS/VS2 System Programming Library: 
JESS Debugging Guide, GC28-0703 and OS/VS2 MVS System Programming 
Library: JESS, GC28-0608. 

Syntax Information: The form^jts of the commands described in this publication 
conform to the following rules.^ 

• Uppercase letters and words, as well as the following special characters, are 
coded exactly as they appear: 


ampersand 

O 

parentheses 

asterisk 

• 

period 

comma 

9 

question mark 

equal sign 

/ 

solidus 

dash 

<> 

carets 


Note: All commas can be replaced by a space. 

• Lowercase letters, words, and symbols represent variables for which specific 
information is substituted when the parameter is coded. 

• Braces, { } , are a special notation and are never coded. They are used to 
group alternative items, one of which must be chosen. If one of the group is 
underlined, it is assumed as the default. 

• Brackets, [ ], are a special notation and are never coded They indicate 

that coding the enclosed item or items is optional. You can code one or 
more items or none. 

• An ellipsis,..., is a special notation and is never coded. It indicates that 
the preceding item can be coded more than once in succession. 

• The first asterisk (*) in a command can be replaced by an eight (8). 


Fourth Edition (September 1979) 

This is a major revision of, and obsoletes, GX23-0003-2. This edition applies 
to Release 3 (Selectable Unit ID5752-826) of Job Entry Subsystem 3 (JI -S3) with 
changes to support systems netowrk architecture remote job processing (.SNA RIP) 
and to all subsequent releases and modifications until otherwise indicated in new 
editions or technical newsletters. Changes are continually made to the information 
herein; before using this publication in connection with the operation ot IBM 
systems, consult the \ 2 itest IBM System/S70 Bibliography, GC20-0001, for the 
editions that are applicable and current. 

Publications are not stocked at the address given below; requests for IBM publi¬ 
cations should be made to your IBM representative or to the IBM branch office 
serving your locality. 

It is possible that this material may contain reference to, or information about, IBM 
products (machines and programs), programming, or services that are not announced 
in your country. Such references or information must not be construed to mean 
that IBM intends to announce such IBM products, programming, or services in your 
country. 

Comments concerning this publication may be addressed to IBM Corporation 
Department D58, Building 706-2, P.O. Box 390, Poughkeepsie, New York, 12602. 
IBM may use or distribute any of the information you supply in any way it believes 
appropriate without incurring any obligation whatever. You may, of course, 
continue to use the information you supply. 

© Copyright IBM Corp. 1976, 1977, 1978, 1979 



JES3 OPERATOR COMMANDS 


Command 

Description 

Type 


1 


*X,dspname[,message text] 

Call a dynamic support program into execution. 

(Note 1) 

•CANCEt or *0 

i BilililiiW ' ii 


*c. . 

dspname \ 

dev 1 

J=jobno [ ‘"''1 

Iname I 

main / 

Cancel the specified DSP or the DSP on the specified device, line, or processor. 

J= specifies the JESS job number of the DSP. 

(Note 1) 

♦DELAY or *D 



*D,nn 

Change the time interval between messages displayed on the graphics console. 
Acceptable values are 0, 1/4, 1/2 and 1 through 20. 

Delay interval of 0 for the 3277 initiates page mode operation. 





IIIIIIIIIIlQIlIQIQIIIIIIIIIIIIIIII^ 

Terminate I/O operations on the specified console. 





*DUMP[.pass word] [,title] 

Force an abend of JESS and return to MVS. Password is required when used 
on the local processor. Title may be 60 characters or less. 


♦ENABLE or *N 



*N,con 

Reinitialize I 'O ojicrations on the specified console. 



& „ -Mi' , J'''-.J 


*E 

Erase contents ot the graphics display and reposition the cursor. 



M'- mK 


1 dspname \ 

devadr '’^^*^'’1 

V J=jobno / 

Force termination when the DSP will not respond to *CANCEL„ J= specifies 
the JESS job nuinl)er of the DSP. 





=*^1 lU 1 

Terminate all messages queued to the console from which this command is 
entered. 


♦INQUIRY or ♦! 

flfli 


*1,A 

,main 

,D=dspnamc 

,D=ALL 

,D=DL1N1- 

,D=DEADLINi; 

blank 


Display jobs currently on the named processor. 

Display jobs being processed by the designated DSP. 

Display all jobs being processed by all DSPs. 

Display all active jobs in the deadline queue. 

Display jobs being processed by the DEADLINE DSP. 

Display jobs cunently on all processors. 

Active jobs 

*I,B ■ 

( ■" ] 

,main I 

blank V 

.■r=Brp 

, ,G=dcv group / 

Display jobs in the resident job queue. 

Display jobs cligilile for the specified processor. 

Display backlo|t of all jobs. 

Display backlog of jobs for the specified terminal group of origin. 

Display jobs originating from the designated device group. 

Backlog jobs 

NOTE: 

1. See "Contents" for JESS functions listed by area and name. 












JESS OPERATOR COMMANDS 


Command 

Description 

Type 

•INQUIRY or *1 (cont.) 



[ blank \ 

Display status of JES3 buffer pool. 

Buffer pools 

,c 

Display status of JES3 console buffer pool. 


\ ,C,R j 

Display status of JES3 console buffer pool and reset buffer counters to zero. 



blank 

i — 1 

,N ={ nnn > 

{ ALL j 

,D=(dcv,.. . ) 

I (lname,(,lname]1 
I ALL / 

j (wsname,[vvsnanie)...) \ 

’ I ALL I 

,(main{,main]...) 

,V=(vol[,vol]...) 

,MSU=unit name Fj ,ALL \ 

,SDG=nn \ ,main j 


it name j ,ALL \ 
1^1 ,main j 

[group } 


:,(cls(,cls]...)] 


( (jobname[jobname]...) \ 

(jobno( Jobno]...) > l,P] l,T=termgrp| 

(jj*[Jj*]...) j 


*LK I ,N=(tab[,tab]...) I 
[ =nn,N=(tab[,tab]...) j 

*I,L[,T=(type[,type]...)] 

*I,M,main{,(cde[,cde] „.)] 

( blank P 

j=j (jobname[ jobname]...) 
,ID=(net[,net]...) ’ ( Oot)no[ jobno]...) 

L ,LIST 


Display status of the first 10 global processor devices. 

Display status of the specified number of global processor devices. 

Display status of specified device(s). 

Display status of the specified or all BSC RJP lines. 

Display status of the specified or all BSC RJP or SNA RJP work stations. 

Display status of devices on specified processor. 

Display status of device on which specified volume is mounted. 

Display the status of the designated mass storage unit. 

Display the status of the designated staging drive group. 

Display current select mode options or specified options. Valid options are: 
MAGER, MAGEE, SAGER, SAGEL, DISPLAY, DPRTY, SDEPTH, SBAR, 
INCR, INCL, CHOICE, LSTOR, MODE, MAXI. 

Display execution resource status of all or specified job class groups. 

Display status of all or specified job classes. 

Display GMS checkpoint record in dump format. 

Display select mode records in dump format. 

Display the status of specified job name/number. 

Display jobs whose names begin with the characters up to the “ * ” 

Display estimated lines/cards (actuals if processing is complete). 

Limit display to jobs from specified terminal group. 

Display all PI K and SP table names. 

Display predefined message for designated key (1 to 12) from specified table 
name. 

Display all or specified deadline scheduling types. 

Display MC’S code routing for all or specified codes. 

Display status of all active DJC networks. 

Display status of designated job name(s)/number(s) within specified net(s). 
Multiple network IDs, or job name/numbers may not be given together. 
Display status of all jobs in specified net(s). 


JES3-managed 

devices 


General ized 
main 

scheduling 

(GMS) 


JESS jobs 


PFK and SP 
tables 


Deadline 
MCS route codes 
DJC networks 


=(con[,con]...) 
=(con[,con] ...),K 
=(con[,con] ...),main 
=(con[,con] ...),DEST 
,D 


Display status of all JES3 consoles. 

Display name and status of console from which command was entered. 

Display status of designated console. If no console is specified, ail are displayed. 
Display PER and SP table for designated console. 

Display MCS console ID of specified console on specified processor. 

Display JES3 destination classes for specified console. 

Display all JES3 consoles that are queued to depth. 


*I,P=prty ,N- 


|,T=term] 


Display status of first 10, nnn, or all jobs of the specified priority (00-15). 
Limit display to jobs submitted from specified terminal. 






JES3 OPERATOR COMMANDS 


Command 


^INQUIRY or (cont.) 


Description 


,D=dspnamc 

^ ,C=cls 
,G=grp 
^ ,J=jobno 

_ j device group 


— 
N= < nnn 
I ALL 


Display all jobs in system queue. 

Display amount of spool space left. 

Display status of jobs queued for specified DSP. 
Display the jobs in operator hold status. 

Display jobs of specified job class. 

Display jobs of specified group. 

Display job queue beginning at specified job number. 

Display jobs submitted from specified device group. 
Display jobs submitted from specified terminal group. 

N= specifies the number of jobs to display. 


Job queue 


.dspname 


blank 
, J=jobno 
,C=Snn 


Display all outstanding operator action messages. 
Display action messages for specified processor. 

Display action messages for specified DSP. 

Display all outstanding setup operator action messages. 
Display setup messages for specified job number. 
Display setup messages for specified setup console. 


Outstanding 

replies 


[,J=jobno] 


I vol [,!■: 
ALL i,i-: 

Ri:s 

. .VI K 


Display the current in use, allowed (ALWIO) and maximum (MAXIO) number 
of asynchronous I/O requests w'hich can be processed simultaneously. 

Display summary of MDS queues. 

Display jobs currently on MDS fetch queue. 

Display jobs currently on MDS WAITVOL queue. 

Display jobs waiting to be verified by setup. 

Display jobs having their device requirements deallocated. 

Display jobs in MDS allocate queue or specified job from that queue. 

Display jobs waiting for unavailable volumes. 

Display jobs in MDS error queue or specified job from that queue. 

Display jobs in MDS restart queue or specified job from that queue. 

If J=jobno IS .>pccified, more detailed information concerning that job is given. 
Display status of fully qualified data set name (separated by blanks or commas, 
not periods). 

Display status of fully qualified data set name (separated by blanks or commas, 
not periods) and list all jobs referencing data set. 

Display status of specified volume. If E specified, list jobs referencing volume. 
Display count of MDS-managed volumes. If E, list all managed volumes. 
Display volumes specified on SETRES statement. 

Display the current value of the MSVC virtual unit reserve count. 


(lname[ ,lnamej...) 


,STAT(,R| 


Display password for all or specified BSC RJP line names. 

Display line error statistics for all or specified BSC RJP line names and 
optionally reset counters to zero. 


BSC RJP lines 









JES3 OPERATOR COMMANDS 





JES3 OPERATOR COMMANDS 




Command 


Description 


Type 


♦INQUIRY or ♦! (cont.) 




[,CONS=con] 
_10 

.N= { nnn 
ALL 


Specifies console to receive response. If omitted, respond to requesting console. 
Display the specified number of lines of response. 


Output service, 
writer queue 
(Note 3) 



) \ 

,J= 

jobname > 

[ jobno ) 


Display status of all (?) or specified jobs in the queue, giving job name and 
number and summary of output by job. Display the status with qualifications 
as specified by the following parameters. 




Display status of all (?) or specified ddnames for specified job. If specified, 
the ddname must be qualified as it appears in the job’s JCL (jobstepname. 
procstepname.ddname); names that are omitted must be indicated by 
including the period (for example,... S YSMSG). S= specifies the sequence 
number for identical ddnames. 


*I,U[,0=WTR] 


ds} 

LI 

{ form I 


Y 
N 
■> 


,ID= 




userid 


ininline count 

,P= I ■ ] 

I prty I 
,T=device group 

■c-r’ 1 

( PRT ] 
,GT=| PUN \ 

\ SYS j 

I devtyp I 
,U= L . } 

[ train ) 


Display the data set selection characteristics that are preventing writer 
scheduling for specified job name or number (?), or display summary infor¬ 
mation for each general type of output in the writer queue (ALL). 

Display SYSOUT classes in writer queue or status of data sets of specified 
SYSOUT class. 

Display destination of jobs in writer queue or status of data sets for specified 
destination. 

Display form requirements for data sets in writer queue or status of data sets 
requiring specified form. 

Display hold status of all data sets (?), or only data sets in hold status (Y), or 
only data sets not in hold status (N), 

Display TSO user IDs having data sets in writer queue or status of data sets 
for specified user ID. 

Display line counts for data sets in writer queue or set minimum line count of 
data sets to be displayed. 

Display priority of data sets in writer queue or status of data sets of specified 
priority. 

Display status of data sets destined for, or originating from, specified device 
group. 

Display carriage (LXB) requirements or status of data sets for specified 
carriage (FC’B). 

Specifies general type of data sets to display. 


Display specilic device type requirements or status of data sets for specified 
device type. 

Display UCS ID (train) requirements or status of data sets for specified UCS 
ID. 


NOTE: 

3. If Q= is not specified, WTR is assumed. 


JES3 OPERATOR COMMANDS 


© 


Command 


Description 

— 


Type 


»INQUJRY or’l (cont.) 










[,CONS=con] 
10 

,N= •( nnn 
ALL 


.J= ^ jobnume 
jobno 


*1,U(,Q=WTR] 


,CH= ^ 


,FL= 


,CM= 


,ss= 


f (images(.images]' 

I 

I image 
nid 

7 

NONi: 
cmid 

(cmid.trc) 


NONE 


Specifies console to receive response. If omitted, respond to requesting console. 
Display the specified number of lines of response. 


Display status of all (?) or specified jobs in the queue, giving job name and 
number and summary of output by job. Display the status with qualifications 
as specified by the following parameters. 

Display data sets with the images listed. 

Display image requirements of data sets. 

Display data sets requesting the specified image (any occurrence of image 
within the CHARS= parameter); if enclosed in parentheses, the request is 
for a precise match. 

Display data sets requesting specified forms-overlay name. 

Display forms-overlay requirements. 

Display data sets without forms-overlay requirements. 

Display data sets requesting specified copy modification module ID. 

Display data sets requiring specified copy modification module ID and 
reference character. 

Display copy modification module ID requirements. 

Display data sets without copy modification requirements. 

Display data sets requiring continuous stacker selection option. 

Display data sets requiring the bursting, trimming, stacker selection option. 
Display stacker select requirements. 


Output service, 
IBM 3800 
Printing 
Subsystem 
(Notes 2, 3) 


*I,X 


’,dH 

dspname \ 

ALL ) 

,M=^ 

f module name 1 


1 ALL 1 


Display use count status of specified or all JES3 DSPs. 

Display use count status of specified or all JES3 modules loaded by the 
ALOAD macro instruction. 


DSP and 
module use 
counts 




,con 

.dost 

,ALL 


Send a message (text) to specified console. 

Send a message to specified console destination class. 

Send a message to all consoles except those with DEST=NONE. 




^MODIFYor 






*1 ,L 


,ON 

,OFF 

,START= 

,STOP= 

,EXCL= 
,LlMlT=nn 


PGMCHK 

RESUME 

PGMCHK 

WAIT 


id 

RESET 


,DUMP= 

.DISPLAY 


id 

ALL 


,TRAP= 


address 
Ri:SET 
,ITND=module name 


Enable event tracing. 

Disable event tracing. 

Reset STOP=WAIT and force a program interrupt. 

Trace facility is to post and return control to caller. 

Any time an entry in the exclusive ID queue is traced, the calling function is 
to be 0C6 abended. 

Any time an entry in the exclusive ID queue is traced, the calling FCT is to be 
awaited. 

Add specified trace ID to exclusive ID queue (maximum of 10). 

Reset exclusive ID queue and resume tracing of all entries. 

Specified number of entries that are to be dumped to operator console (00-99). 
If 00 is entered, 255 is used. 

Specified trace ID or all trace IDs are to be dumped to the operator console 
subject to LIMIT=. 

Trace control data area is to be dumped to the operator console. 

Set a dynamic trace (ID=1) at specified address. TRAP overlays 8 contiguous 
bytes from the address and destroys contents of registers 0, 1, 2, 14, and 15, 
Reset the active trap and restore overlaid instructions. 

Locate module entry point. 


Event tracing 
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© 


Command 


Description 


Type 


♦MODIFY or*F<cont.) 


,G 

,GROUP 


,grp 


*F,G,main 


,ON 
,OFF 

,INIT,nnn 
,ALLOC,opt 

,UNALLOC,opt I 

,BAR,nn 
,JSPAN,nnn 


;Llect1 


,CLASS I ,cls 
,CHK 


,ON 

,OFF 


For the specified system: 

Enable or disable the named group for scheduling. 

Set named group initiator count to nnn. 

Set allocation option to specified option (DYNAMIC, MANUAL, or DEMAND 
- MVS processors only). 

Set deallocation option to specified option (DYNAMIC, MANUAL, or 
DEMAND ” MVS processors only). 

Set group scheduling barrier to nn. 

Set group job span to nnn. 

Set current select mode option (MAGER, MAGEL, SAGER, SAGEL, DISPLAY, 
DPRTY, SDEH II, SBAR, INCR, INCL, CHOICE, LSTOR, MODE, MAXI) to a 
specified value. (MAXI is valid only if maximum initiator value has 
been set due to an *START command failure). 

Enable the named class. 

Disable the named class. 

Checkpoint the current GMS status. 


Generalized 

main 

scheduling 


*1-. I=(jobno[ Jobno] ...) 


,R 

,C 

,CP 

V ,P=prty 


Hold specified job. 

Release specified job. 

Cancel and purge specified job. 

Cancel specified job and process output data sets ready at command entry time. 
Change priority of the specified job to the specified priority (0-15). 


JES3 jobs 


*l-,K=nn,N=ptablc,M= <tcxt > 


,E 

,D 


Set PFK (K=nn) in the specified table to message text for immediate entry (E) 
or delayed (D) entry with cursor positioned at end of text. 


Program 
function key 


*l ,L,T=typ 


■in 


,PRTY^ 


nnli 

,LFAD=-( nnnnM 
hhmm 


,PINC 


■c: I 


nnll 

,INT= •( nnnnM 
hhmm 

.ALL 


For the specified deadline type: 

Increase priority by +nn when lead time occurs. 

Set priority to nn when lead time occurs. 

Specifies lead time prior to deadline time and date to have priority incremented 
(maximums are 24H, 1440M, 2400). 

Specifies additional priority changes after initial lead time elapses. Increment 
by +nn or set to nn. 

Interval at whicli PINC= is to be applied. Maximums are same as LEAD=. 

Apply changes to ;ill jobs of specified deadline type in JES3 queue. If omitted, 
apply only to new jobs. 


Deadline 

scheduling 


*l',M,main,(cde(,cde]...) 


,con 

,dest 


For specified processor and MCS code (1-16): 

Set JESS console name to receive messages. 

Set JESS destination class to receive messages. If con and dest are omitted, 
messages arc sent to MLOG and/or DLOG. 

Messages to be processed entirely by JESS. If omitted, message is displayed 
by MCS and processed by JESS. 


MCS route 
codes 

(Notes 4, 5) 


,N,ID=netid[ ,J=(jobno[ jobno]...) 


,I 

,D 

.H 

.R 

,C 


For specified D.IC network and specified job (all jobs if omitted): 

Increment NHOLl) count by 1. 

Decrement NHOLl) count by 1. 

Place in DJC' operator hold. 

Release from DJC operator hold. 

Cancel from the system. Any output data sets created are processed. 

Jobs of specif ied DJC network-ID are purged of all DJC dependencies and 
placed in operator hold. 

The specified network ID is removed from the system. 


DJC network 


NOTES: 

4. Parameters con, dest, and J are positional. 

5. MLCi is the destination class for master log (MLOG). 
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Command 


*IVIODIFYor*F (cont.) 


ISllo°?rl 


,ADEST=destination 
, DDE ST - de st ina tion 


,PFK=tab 

,SP^tab 


MAIN-raain,R= I 


*F,Q[,P=(prty,.. ,)] 


[ ,VU= 1 I T-vol[,vol]... I 
j ,VA= 11 D-vol[,vol]... I 

,M- I devtyp v ,main,vol 
( SDGxx j 

{ dev adr \ 

devtyp i ,main 
vol j 

, J-jobno, V 


,ALWIO=nn 


5 

( wsnamel 
ALL ( 


I old password 1 I new password I 

'^■Mnone I’Inone P 


Turn MLOG on or off (MLOG cannot be disabled unless DLOG is active). 
Turn DLOG on or off (DLOG may not be disabled unless there is at least 1 
hardcopy MLOG active). 

Set authority level for specified console (0-15). 

Add a destination class to specified console. 

Delete a destination class from specified console. 

Specify processor to which all commands not prefixed with * or 8 are sent. 
NONE indicates that JES3 is to process all entered commands. 

Specify new Pl-K table to be associated with this specified console. 

Specify new SP table to be associated with the specified console. 

Delete the specified outstanding operator-action Requestor requests from the 
queue for the specified processor. 

For specified priority level (or all if P= omitted), hold or release the JESS 
queue for scheduling. 

Specifies that designated tape/disk volumes be made unavailable (VU) or 
available (VA), 

For specified system name and volume serial, mount on direct access device 
address ddd, type devtyp, or staging drive group xx. 


Unload the specified volume. 

The specified job number is to enter verify immediately even if mount mes¬ 
sages have not been responded to. 

Set allocation mode to automatic. 

Set allocation mode to manual (requires operator to issue *START,S,jnn to 
FETCH messages). 

Set the current number of asynchronous I/O requests which can be 
processed at one time to nn. Minimum is 1 and the maximum is the 
value specified in the MAXIO parameter of the SETPARAM initialization 
statement. 

Set the MSVC virtual unit reserve count to n. 


T= determines whether the command applies to a specific or all work stations. 
Enable the SNA RJP reader auto call function 
Disable the SNA RJP reader auto call function. 

Hold input from subsequently called readers. 

Reset the hold condition established by the H parameter. Do not release jobs 
currently held. 

Release all or the specified number of batches held via the H parameter. 

Specifies action to be taken if remote printer or punch becomes not ready; 
R-reschedule, C-remain active until made ready. The JOB= parameter 
is valid for BSC RJP only. 

Specifies a new password for the specified BSC RJP or SNA RJP work 
station or none. 


Job queue 


MDS setup 


BSC RJP or 
SNA RJP 
work stations 
and BSC 
RJP lines 


,SNAPON 

,SNAPOFF 

,TRCEON 

,TRCEOFF 


L= determines whether the command applies to all or BSC RJP specified 
lines. 

Hold input from subsequently called readers. 

Reset the hold condition established via the H parameter. Do not release 
jobs currently in hold; they must be individually released or released via 
*F,T=term,B=. 

Specify the line password or NONE which must be used on next BSC RJP 
sign-on. 

Automatically start BSC RJP lines when BSC RJP is reinitialized. 

BSC RJP lines require manual start when BSC RJP is reinitialized. 

Fnable or disable SNAP facility. 

1 nable or disable display of BSC RJP event trace on MLOG. 
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Command 

Description 

Type 

' ' ' ' 

^ ♦MODIFYor*F(contJ 

' ^ V 


l,CONS=conl 

r jiiL 

,N= < nnn > 

L 1 ALL J J 

I jobno 1 

1 jobnamc j 

,DD=ddname [ ,S=nnn ] 

,T=dcvice group 

,ID=uscrid 

,D=dest 

,ND=ndest 

,I'=form 

*F,U,Q=HOLD 

,L=nrin 

,CL=class 

,NCL=nclass 

,P=prty 

,NP=nprty 

,CP=nnn 

,NCP= |{ + |-h |& ) ) nnn 

,cancl:l 

,NQ=WTR 

,W=cxtcrnal writer name 

,NW==next writer name 

,DSID=dsid 

,NDSID=ndsid 

Specifies console to receive response. If omitted, requesting console 
is to receive responses. 

Specifies the number of requests to be processed; this represents 
jobs, data sets, or output scheduler elements, depending on other 
specifications. 

Specifies the Job from the designated queue to be changed. 

Identifies specific ddname to be modified. If specified, the ddname must be 
qualified as it appears in the job’s JCL (jobstepname.procstepname.ddname); 
names that are omitted must be indicated by including the period as a qualifier 
(for example,... JESMSG). J= must be used if DD= is coded. S= is used to 
identify sequence of identical ddnames. 

Modify data sets destined for designated device group. 

Modify data sets of designated TSO user ID. 

Modify data sets destined for specified destination. 

Specifies a new destination. 

Modify data sets with the designated form. 

Change forms to specified form (nform). 

Modify data sets with at least nnn lines. 

Modify data sets of specified SYSOUT class. 

Change SYSOUT class to specified class (nclass). 

Modify data sets of specified priority. 

Change priority to specified priority (nprty). 

Modify data sets with designated copy counts. 

Copy count is to be added, subtracted, multiplied, or divided by nnn, or set 
to nnn. 

Cancel output as qualified by other keywords (job, data set, etc.) 

Place data set selected on the basis of additional qualifying parameters on the 
writer queue. 

Modify output destined for designated external writer. 

Output is to be destined for the new designated external writer. 

Modify designated data sets for 3540 Diskette. 

Change the data set ID to the new data set ID (3540 Diskette only). 

Output service 
hold queue 
(Notes 6,7) 

NOTES: 

6. The *MODIFY,U command is presented in three different formats here: 7. In the many variations of the *IVIODIFY,U command, parameters may be 

*F,U,Q=HOLD for jobs on the hold queue; *F,U,Q=WTR for jobs on the used together to qualify the requested change. If specific parameters must 

writer queue; and *F,U,Q=WTR with additional parameters only for the be used in combination, they are presented on the same line in the format. 

IBM 3800 Printing Subsystem. Parameters that may be used with either The Nxx parameters affect data sets selected on the basis of additional 

Q=HOLD or Q=WTR are repeated; the others may only be used as shown. qualifying parameters. 

For the IBM 3800 Printing Subsystem parameters, Q=HOLD must not be 
coded. 





JESS OPERATOR COMMANDS 


Command 


*MODIFYor *F(cont.) 


— 

,N= \ nnn 


Description 


*F,Ul,Q=WTR 


jobno 

jobname 


,DD=ddnamel,S=nnnl 


,T=device group 


,P=prty 

,NP=nprty 

,NCP- ( I + I - I * I & ) I 
.CANCEL 


,NST=ntyp 


,NC=ncarr 


,NU-nucsid 



Specifies console to receive response. If omitted, requesting console 


is to receive responses. 

Specifies the number of requests to be processed; this represents 
jobs, data sets, or output scheduler elements, depending on other 
specifications. 

Specifies the job from the designated queue to be changed. 

Identifies specific ddname to be modified. If specified, the ddname must be 
quahfied as it appears in the job’s JCL Oobstepname.procstepname.ddname); 
names that are omitted must be indicated by including the period as a 
qualifier (for example,... JESMSG). J= must be used if DD= is coded. S= is 
used to identify sequence of identical ddnames. 

Modify data sets destined for designated device group. 

Modify data sets of designated user ID. 

Modify data sets destined for specified destination. 

Specifies new destination. 

Modify data sets with designated forms. 

Change forms to specified form (nform). 

Modify data sets with at least nnn lines. 

Modify data sets of SYSOUT class. 

Modify data sets of specified priority. 

Change priority to specified priority (nprty). 

Copy count is to be added, subtracted, multiplied, or divided by nnn, or set 
to nnn. 

Cancel output as qualified by other parameters (job, data set, etc.). 

Modify data sets of specified general type. 

Modify data sets of designated specific device type. 

Change device type to specified type (ntyp). 

Modify data sets requiring designated carriage type (FCB). 

Change carriage tape (FCB) name to specified carriage name (ncarr). 

Modify data sets requiring designated UCS (train). 

Change UCS-ID (train) to specified train (nucsid). 

Modify data sets of designated hold status. 


Output service 
hold queue 
(Notes 6,7) 


Change hold status as specified. 


Change hold queue type to indicate ASP-JES3 migration aid. 


[ ,CONS=con] 

[■'‘■fTLl] 

,j= 1 jobno \ 

L ’ I jobname I J 


Specifies console to receive response. If omitted, requesting console 
is to receive responses. 

Specifies the number of requests to be processed; this represents 
jobs, data sets, or output scheduler elements, depending on other 
specifications. 

Specifies the job from the designated queue to be changed. 


Output service 
writer queue, 
IBM 3800 
Printing 
Subsystem 
(Note 6) 




JES3 OPERATOR COMMANDS 



Command 

Description 

Type 

•MODIFY or *F (coot.) 



*r,U,[Q=WTR] 

,I L=tlid 

“»i 

■“■Is 1 
■“S-| s 1 

( cmid \ 

,NCM= ] (cmid,trc) J 
[ NONE j 

[ image 1 

,CH= I (image 1 [,imagc2,images, r 

1 imagc4]) j 

nch= I \ 

1 (image 1 [,image 2, image3,image4] ;»j ^ 

Modify data sets requesting specified FLASH ID. 

Change FLASH ID to specified ID (flid), or NONE indicating no FLASH 
requirement. 

Modify data sets requesting specified continuous (C) or bursting, trimming 
stacker select (S) option. 

Change stacker select option to continuous (C) or bursting, trimming 
stacker select (S) option. 

Modify data sets requesting specified copy modification or copy modification 
and reference character. 

Change copy modification requirement to specified value. 

Modify data sets with specified image requirements (any occurrence of image 
within the CHARS= parameter); if enclosed in parentheses the request is for a 
precise match. 

Image requirements are to be changed to specified value. This can only be 
specified if CH= was used as a selection specification. 


|*MODir Y| 

<T,(dev[,dev].,.) 

,(dev adr[,dev adr] ...> 
,(dev adr-dev adr) 

,cuX 
< ,main 
,ALL 
,Iname 
,SDGxx 
,mssname 

1 ,(con[,con] ...) ] 

< ,(con adr[,con adr] 
y_^i,(con adr-con adr) j 

/, ONLINE \ 
l,ON 1 

1 ,Or FLINE j 
i,OFF j 

'.ONLINE ' 
,ON 

^ .OFFLINE 
.OFF 

,,CONSOLE . 

(,mainl 

1 all / 

Specify the availability or unavailability of JES3-managed units for use by JES3 
support functions or specified processor. 

The control unit is specified as cuX (for example, 23X). 

Specification of CONSOLE enables specified device addresses as JES3 consoles. 
Specification of ALL as the last parameter can only be used when SDGxx or 
mssname is specified. 

Vary function 

j ,D=dsp ,MC-J 

*r,x < j 

nn 'i \ 

(,mm) (. 1 

(nn,mm)V / 
ount j 

Specifies maximum number of copies of the designated DSP that may be active 
at one time (0-32767). When D=CI, the total of the subparameters must not 
exceed 99. When D=RI, only one number should be specified. 

Specifies the number of times the designated module is to be loaded by the 
ALOAD macro instruction before it is made resident (2-32767). 

DSP and 
module usage 

•RESTART or‘R 

''fit"’; -I 


*R • 

1 ,dspname I 

1 1 

,dev adr \ [^message text or parms] 

1 I 

1 ,J-jobno 1 

Restart a JES3 global support function or jobs on an ASP main processor (for 
details, see the JES3 Functions section). 


•RETURN 


\ 

* RETU RN [ .password 1 

Terminate JES3 and return to MVS without a dump (password is required 
when command entered on a local processor). 



'IHK 


*T,main,consolc command 

Send the designated MVS console command to the specified processor. 





*s< 

jdspname 
,dev 
,dev adr 
J=jobno 
,main 

>• [,message text or parms] 

Start a JES3 global support function (for details, see the JES3 Functions 
section). 













JESS OPERATOR COMMANDS 



Command 


Description 


SWITCH 


Reroute messages destined for from console to console. Messages so 
routed are prefixed with the symbol #. 


SWITCH, from console, to console 


VARY or *V 


,(dev[ ,devj „.) 

,(dev adr[,dev adrj 

,(dev adr-dev adr) 

,cuX 

,main 

,ALL 

,lname 

,SDGxx 

,mssname 


.ONLINE 

,ON 

.OFFLINE 

.OFF' 


Alter availability or unavailability of JES3-managed devices (same format 
and meanings as *F,V,. , .). 


VARY 


.ONLINE 

.ON 

.OFFLINE 

.OFF 

.CONSOLE 


JESS FUNCTIONS 



Function; The card-to-card (CC) DSP reproduces EBCDIC or binary cards and converts BCD cards to EBCDIC. In addition, it can reproduce with 


sequencing or gangpunching, make multiple copies of a card, and rearrange fields in output. 



Description: 

Specifies input device by name, address, or type and/or group. If omitted 
RDR is assumed. 

Specifies output device by name, address or type and/or group. If omitted 
PUN is assumed. 

Sets cancellation or rescheduling if devices are not available. The default is as 
assembled in lATYDSD. 

Specifies type of operation: 

B ~ binary reproduction 

C - conversion from BCD to EBCDIC 

S - sequencing, gangpunching, and/or field rearrangement. 

Each field must contain 8 numbers. 

The identifier is 1-8 characters. 

Specifies sequencing information. 

Specifies identifier to be gang punched. 

Specifies number of cards to be punched per input card. 

Specifies if punch is to be interpreted. 

Start the card-to-card DSP. 



^CANCEL 

*C 


Cancel the card-to-card DSP. 







JESS FUNCTIONS 


Cl, Rl DSPs: Interpreter Service 




Function: The converter/interpreter (Cl) DSP for MVS and the reader/interpreter (RI) DSP for MVT/SVS provide JCL conversion and create OS 
control blocks. 


♦MODIFY 


,X,D= ,MC= a,mm) 

I (nn,mm) 


Description: 

Set the maximum concurrent subtask count for the RI or Cl DSP (must be 01-99.) 
When D=CI, the total of the subparameters must not exceed 99. 

When D=RI, only one number should be specified. 


CNTDSP: Console Test :: _ ', y-"-' - 

Function: The console test (CNT) DSP tests mechanical functioning of JESS consoles. 


♦CANCEL 

♦C 


{ dev 
dev adr 
(dev[,dev] ...) 

,CNT ,TEXT=test message 

,REPEAT= nn 


Description: 

Call the CNT DSP. 


If omitted, calling console is assumed. 


May be 1-20 characters. If omitted, a standard test message is used. 
The parameter nn can be 0-5. 


Cancel the CNT DSP. 


CP DSP: Card-to-Printer 


Function: The card-to-printer (CP) DSP lists EBCDIC cards, with single-spaced, double-spaced, or triple-spaced output. 


Command: 


Description: 


(dev ] 

,IN= I dev adr > 

l([lypl [.group])) 

( dev 
dev adr 

([type] [.group]) 


Specifies input device by name, address, or type and/or group. If omitted RDR 
is assumed. 


Specifies output device by name, address, or type and/or group. If omitted 
PRT is assumed. 


♦CALL 

♦X 


"'START I 
"'S J 

"'CANCEL 

"'C 


,SPACE=| 2 


,CP 

,dev 

,dev adr 

,CP 

,dev 

,dev adr 


Sets cancellation or rescheduling if devices are not available. The default is as 
assembled in lATYDSD. 

Specifies spacing of printer. 


Start the CP DSP. 


Cancel the CP DSP. 





JES3 FUNCTIONS 


CR, DR, T 


Input Servic 


Function: The card reader (CR), disk reader (DR), and tape reader (TR) DSPs spool jobs from cards, tapes, and disk into the JES3 queue during 
the reader phase of input service. 


Command: 


Description: 



Specifies device for CR or TR. 

Specifies input for DR. IN= sets origin group. 

Specifies number of jobs in batch (1-255). 

Enables card image. This must be specified if cards to be read are in card- 
image format (column binary or data mode 2). Valid only for CR. 

Specifies TR input density: 

2-200 bpi (7-track) 

5-556 bpi (7-track) 

8-800 bpi (7- or 9-track) 

16— 1600 bpi (9-track) 

62-6250 bpi (9-track) 

Specifies TR end-of-file action: rewind, rewind unload, or leave. 

Specifies control-card processor job is to be placed in hold status (H) or 
allowed to process (HN) after the batch has been created. 

For TR and DR, specifies job with which job input is to begin. 

Specifies number of jobs (1 to 254) to be read from the input device and 
placed onto the spool devices (TR and DR). 

Specifies whether the reader is to be kept active (K) at end-of-file or is to purge 
(KN). 

For TR, specifies tape is labeled. 

For CR and TR, specifies whether unavailability of the input device results in 
holding the reader function in the system pending availability (R) or cancella¬ 
tion of the reader function (C). 

Specifies priority to be assigned to control-card processor job (0 to 15, 15 is 
the default). 

For TR, specifies blocking factor at which card images are on tape (maximum 
is 40). 

For TR, specifies number of files the tape is to be spaced forward before 
reading begins (0-127; the default is 0). 

Specifies set of reader or converter parameters to be used. 




JESS FUNCTIONS 


CR, DR, TR DSPs: Input Service (cont.) 





Command: 


Description: 


I *START 
*S 


V 


,CR \ 
,DR I 


,TR ! 
,dev 

,dev adr 
,J=jobno^ 




,M=mem 



,END= 


RW ] 
RU i 
NO j 


HN ) 


,J=jobname 



,P=nn 


,TM=nn 

PARMID=| — 

[ XX 







,DR 


\,hnI 

1 ♦cancelI 

,TR 


1 K 1 

♦C 

1 ,dev 


1,’kn} 

V ) 

,dev adr 




^ ,J=jobno, 


,P=nn 


CTDSP: Card-to-Tape 


Specifies name of partitioned data set member (DR only). 
Number of jobs in batch (1-255). 


TR end-of-file action: rewind, rewind unload, or leave. 

Control-card processor job is to be placed in hold status (H) or allowed to 
process (HN) after the batch has been created. 

Name of the job with which job input is to begin (for TR or DR). 

Number of jobs to be read from the input device (1-254) and placed onto 
the spool devices (TR and DR). 

Specifies whether reader is to be kept active (K) at end of file or is to purge 
(KN). 

Priority assigned to control-card processor job (0-15). 

Number of files the tape is to be spaced forward (0-127) before reading 
begins (TR only). 

Specifies set of reader or converter parameters to be used. 

Interpreter DSP created with the *CANCEL command to be placed in operator 
hold (H) or allowed to process those jobs already entered (HN), 

The ^CANCEL command for a hot reader terminates reader function (KN) or 
allows reader to remain allocated (K). 

Priority of interpreter DSP (0-15). 



Function: 


The card-to-tape (CT) DSP stores card files on reels of unlabeled tape. The tapes may be 7- or 9-track, with a selection of density and 
recording modes, and may be single or multiple file, unblocked or blocked. 


Command: 


f *CALL 
*X 


,CT 


(dev \ 

IN= I dev adr > 

l([typ] [.group] )J 
(dev 

OUT= I dev adr 

l([typ] [.group]), 

,NAV=|C} 

,BLOCK= I — \ 

I nn) 

,TM= nn 



♦START 1 
*S I 

♦CANCEL 

♦C 



,CT I 

,dev > 
,dev adr j 


,CT I 

,dev !• 
,dev adr j 


Description: 

Specifies input device by name, address, or type and/or group. If omitted 
RDR is assumed. 


Specifies output device by name, address, or type and/or group. If omitted 
TA9 is assumed. 

Sets cancellation or rescheduling if devices are not available. The default is 
assembled in lATYDSD. 

Specifies blocking factor (0-99) 

Specifies tape marks to be passed from the load point. Omission causes no 
repositioning (0-99). 

Specifies tape density: 

2-200 bpi (7-track) 

5 556 bpi (7-track) 

8-800 bpi (7-or 9-track) 

16- 1600 bpi (9-track) 

62-6250 bpi (9-track) 

Specifies recording mode for 7-track tape: 

C - odd parity, converter on, translator off 
T - odd parity, converter off, translator on 
ET - even parity, converter off, translator on 

Start the CT DSP. 


Cancel the CT DSP. 


JESS FUNCTIONS 


DC DSP: Dump C 


Function: The dump core (DC) DSP permits inspection and modification of data in main storage; intercepts program flow during execution at 
desired locations; and permits formatting of control blocks. 

Command: Description: 


dev 

dev adr 

([typ] [,group]) 
CON 


,KEY=password 


Specifies output device by name, address, or type and/or group to receive the 
output from the OPTION= or PTRAP parameters on the *S,DC command. All 
other output is directed to calling console. If OUT= is not specified, any 
available local printer is selected. 

Specifies calling console. 

Specifics password for setting traps and displaying and altering storage. 


,FIND=module name [,SEQ=nn] 


BASE=address 


,C=address 

,BASE=address 


Locates entry point address and base of named module. 

Identifies one of a series of identically named modules. 

Specifies starting address of data from storage to be displayed, or displacement 
to add to BASE. 

Specifies hexadecimal number of bytes to display. 

Specifies base address of area to display. 

Specifies address of data to be stored, or displacement to add to BASE, 
Specifies 2-16 hexadecimal characters to be stored. 

Specifies base address of area to be altered. 


^START 

^S 


i adr,END=adr | 
Rz,B=length 
* 


Stop at address of instruction specified in TRAP= and begin dump at area 
specified by adr. END= specifies the ending address of area to be dumped. 
Stop at address of instruction specified in TRAP= and begin dump at area 
pointed to by register Rz. B= specifies length of field to be dumped. 

Stop at address of instruction specified in TRAP=. No dump is taken. 
Note: Only four START=* may be active at one time. 


•'RESTART 

•'R 


Iregson \ 

(,REGSOFF f 

(trapon I 

I TRAPOFF 
,PTRAP 

ACTIVE \ 
PATCH / 


i (nam, [,nam]. . .) 
,OPTION= \ DMP 
( SNP 


jobno ( 

(all f_ 


Causes TRAP=address, starting-address, and END= address to be displacements 
to add to BASE. If START=* is specified, BASE= causes only TRAP= to be 
added to BASE. 

Displays registers at a trap. 

Activates or deactivates the display and recording of registers at a trap. 

Activates or deactivates waiting or taking snapshots at a trap. 

Prints snapshot output from traps. 

Displays all active traps or patch area. 

Resumes execution after a wait at a trap. 

Display the named JESS control blocks. See OS/VS2 System Programming 
Library: JES3 Debugging Guide for valid control blocks to display. 

Specifies a JESS dump with all standard formatting. 

Specifies a dump with job-related control blocks recorded^ 


Resets all traps. 


Resets all traps and terminates the DC DSP. 



JESS FUNCTIONS 



DEADLINE DSP: Deadline Scheduling 



Function: 


The DEADLINE DSP allows the operator to control a job’s scheduling priority to increase the probability of the job being completed 
by a given deadline. 


Command: 


Description: 


I I .DEADLINE 


Invokes the DEADLINE DSP. 


^INQUIRY 


See *INQUIRY command in “JESS Operator Commands’’ earlier. 


^MODIFY 


See *MODIFY command in “JESS Operator Commands” earlier. 


*pART I j^jvadLINE 


Reinitialize the DEADLINE DSP. 


I ,DEADLINE 


,PURGE 

,J 


Terminates the DEADLINE DSP until the next deadline scheduling job is read 
into system. With PURGE specified, the DEADLINE DSP can be resumed only 
by a cold start. With J specified, deadline scheduling stops, but the queue is 
still maintained. 


DISPDJC DSP: Display Dependent Job Control Tables 


Function: The display dependent job control tables (DISPDJC) DSP reports the status of a dependent job network. 
Note: Output is an internal JESS spinoff output data set. It is assigned job 0 (i.e., J=0 on an *1, U command). 

Command: Description: 


{ .DISPDJC 


,OUT= 


dev adr 

(type [.group]) 
([type] .group) 


Specifies printer to receive the display. If omitted, PRT is assumed, and JESS 
will allocate the first available device initialized as a PRT type. 

Type specifies the type of device to receive the output. PRT specifies any printer. 
Group specifies the group of devices to which the device has been assigned. 
Usually a physical location such as FLOOR 1 or LOCAL. 



Specifies network to display. 


:CANCELj DISPDJC 


Cancel the DISPDJC DSP. 


DISPLAY DSP 


Function: The DISPLAY DSP displays JESS system tables. 



Note: Output is an internal JESS spinoff output data set. It is assigned job 0 (i.e., J=0 on an *I output command). 


Command: 


I I .display 


,OUT= 


dev 

dev adr 

(type [.group]) 
([type] .group) 


j_ I jobname \ 
\jobno j 
_ ,P=prty 


Description 

Specifies output device by name, address, or type and/or group. If omitted 
PRT is assumed. 

If J= coded, only specific job is displayed and output is returned to calling 
console. 

Specifies to display jobs of the given priority. 


:CANCEL j j^,3plAY 


Cancel the DISPLAY DSP. 



JESS FUNCTIONS 


DJ DSP: Dump Job 

Function: The dump job (DJ) DSP removes jobs from the JESS job queue and writes them to tape; it also reads jobs back into queue from tape. 


dev 

dev adr 

I (type[,group]) 
([typej^roup) 


,NAV={ 

I *CALL I ,PASS=password 


Description: 

Specifies input or output device by name, address, or type and/or group. If 
omitted, TA9 is assumed. 


Specifies action to be taken if device type requested is not available: C-cancel, 
R—reschedule until device becomes available. The default is assembled in 
lATYDSD. 

If DJ has been password-protected by the installation, this is required. The 
password is assembled into lATDJDT by lATYDJB. 

Inhibits the initial rewind which normally precedes DJ processing. This makes 
it possible in OUT mode to recall DJ and add more jobs to the end of an 
existing DJ tape and in IN mode to begin the job scan from the current tape 
position. 


,DEN=nn 


*CANCEL 

*C 


OUT Mode: 


*START 

*S 


,J=jobno I 

,P=prty I 

,N=network id i 

,Q J 

( PURGE 
,D1SP= I SAVE 
[ HOLD 

,CB= (yes) 

NO 


DEN= 

Specifies the tape density: 

2 — 200 bpi (7-track) 

5 - 556 bpi (7-track) 

8 — 800 bpi (7- or 9-track) (default for 7-track) 

16 — 1600 bpi (9-track) (default for 9-track) 

62 - 6250 bpi (9-track) 

800 bpi is the default for 7-track tape; 

1600 bpi is the default for 9-track tape. 

Specifies whether the actual tape I/O is to be bypassed, and a trace of the 
CCWs is made. 


Specifies job to be processed. 

Specifies priority level to be processed. 

Specifies DJC network to be processed. 

Specifies entire JESS queue to be processed except jobs currently active. 

Specifies whether job is to be purged, left in its current state, or placed in hold 
after DJ processing. 


Specifies whether the control block trace is to be made as the control block 
is being dumped. 


♦START 

*S 


,ALL 

,J=jobname 

,P=prty 

,N=network id 

,Q 

,DlSP=HOLD 1 
,OLD 


Specifies that all jobs are returned to the job queue. 

Specifies job to be retrieved. 

Specifies priority level to be processed. 

Specifies DJC network to be processed. 

Specifies entire JESS queue to be processed except jobs currently active. 

Specifies job is to be placed in hold after DJ processing. 

Specifies that the tape is not to be rewound before DJ processing begins. 


DJC DSP: Dependent Job Control 

Function: The dependent job control (DJC) DSP manages jobs that are dependent upon one another; that is, job B (as a successor job) cannot run 
until job A has completed, and job B (as a predecessor job) must be completed before job C is run. 


Commands: See the *INQUIRY and *MODIFY commands in “JESS Operator Commands” earlier. 



JESS FUNCTIONS 


Function: DSI is the JES3 facility that allows a properly configured JESS local processor to assume the role of the JESS global processor in the 

event of a catastrophic error on the current global or if complex reconfiguration is required to prepare for scheduled preventive mainte¬ 
nance, The installation should provide comprehensive procedures for device switching and operator action during DSI. These should 
be carefully reviewed before and during DSI. Operator messages are provided to guide the operator through DSI; the operator responds 
with the *S,DSI command. 


^CANCEL I 
*C I 


*START 

*S 


Messages: 

IAT0920 DSI-CHECK GLOBAL DSI PROCEDURE 

IAT0915 DSI-REVIEW LOCAL DSI PROCEDURE 

IAT0910 DSI-DISABLE OLD GLOBAL PROCESSOR 


IAT0900 DSI-SWITCH GLOBAL DEVICES 


IAT0905 DSI-STARTED 


FAILSOFT 


Description: 

This command is issued from the MCS master console on the local processor 
which is to assume the global function. 

Issued in response to messages IAT0920, IAT0915, IAT0910, or IAT0900 if 
DSI is to be terminated. 

To be issued after performing the actions indicated in messages IAT0920, 
IAT0915, IAT9010, IAT0900 and IAT0905. 


Review global DSI procedure and be prepared to accomplish required tasks 
when requested. Enter *S,DSI to continue. 

Review local DSI procedures and be prepared to accomplish requested tasks 
when instructed. Enter *S,DSI to continue. 

Press SYSTEM RESET or enter *X,DSI on the old global processor. When com¬ 
pleted (JESS no longer active on old global), enter *S,DSI. 

Caution: It is extremely important that JES3 be terminated on the old 
global processor. Failure to do so may destroy JESS spool integrity. 

Set switching devices to enable channel paths to global processor devices 
(console, unit-record, TP, etc.) and local processors as required. When com¬ 
pleted, enter *S,DSI. 

Wait for JESS hot start of new global processor to complete, then resume 
normal JESS operations. JESS may be initialized on the old global processor 
when it becomes available in local mode without an intervening MVS IPL. 


Function: JESS failsoft is the component of the system which attempts to recover from program failures in JESS, The operator is involved if 
WANTDUMP=ASK is specified on the OPTIONS statement. 

Command: Description: 

*FAIL Sec the *FAIL command, in “JESS Operator Commands” earlier, for operator- 

initialed failure of a DSP. 

Message: If WANTDUMP=ASK is specified on the OPTIONS statement, an OS WTOR 

is issued to the active MCS console on the JESS processor (global or local). 
*nnIATS714 SPECIFY NO-NODUMP, J-JESS CONTROL _ ^ r u f ^ r.t.'rirvxTc 

BLOCKS U-JESS DEFAULT JESS default is specified via DUMP= on the OPTIONS statement. 

The JliSS task is in the 0/S WAIT state until the operator responds to IATS714. 
JESS remains nondispatchable until the indicated dump type has been taken. 










JES3 FUNCTIONS 


UP DSP: Internal Job Processing 


Function: 

The internal job processing (UP) DSP provides a 
on ASP main processors. 

generalized interface to allow other jobs to interface to JESS during program execution 

Command: 



Description: 


♦CALL 
♦X ) 

,IJP[,IN=main] [,H] 

H specifies that all transmitted jobs are to be placed in hold status. 


♦START 1 , ( ,H 1 

♦S 

Sets or resets placement of jobs in hold status. 


♦CANCEL 
(*C ) 

1 \ 

\ ,ijp 1 

The login name is provided in the sign-on message. 

*C,IJP is valid only when there is only one UP DSP active. 

mTODR DSP: Internal Reader 

- 

Function: 

The internal reader (INTRDR) DSP passes JESS output data sets to JESS input service for processing as an input job stream. 

Command: 



Description: 

1 

*CALL 

*X 

,INTRDR 

Starts the internal reader DSP for processing jobs in the output writer hold 
queue. 


! ♦CANCEL 

1 *C 

. .INTRDR 

Terminates the INTRDR DSP. 




Function; The ASP-JES3 migration aid provides the facility to transmit jobs from an ASP support processor to a JESS global processor, maintain 
the jobs on the ASP queue in case of a failure on the JESS system, and receive and process output data sets from the job’s execution on 
JESS. The migration aid also provides the JESS queue dump facility. This facility allows the user to transmit, from the JESS system to 
an ASP system, (a) SYSOUT data generated by jobs which did not originate on the ASP system and (b) the input queues. The callable 
DSPs, JESAID and ASP AID, operate in JESS global and ASP support processors, respectively. Operator commands for ASPAID are 
entered on ASP and for JESAID are entered on JESS. 


JESAID Command: 
*X,INTRDR 


*CALL 


,JESAID 


,CTC=adr 


,RDR- 


,WTR= < 


STOP 

(START,reader name) 


HOLD 


STOP[,alt dest] 


START[,alt dest] 
,DUMP=ALL 

,STATUS 

,HOOK 
,LOOK 


Description: 

Prior to calling JESAID, an internal reader must be active. If one is not, enter 
*X,INTRDR 

Specifies address of the CTC to be used by JESAID to communicate with the 
ASP main processor. (This may be omitted if specified on the *S,JESAID 
command. 

Stops or starts the JESAID reader function. The reader name is the name defined 
on the DEVICE statement for the JESAID reader. 


HOLD causes the JESAID writer to terminate on completion of active data set. 
Other output remains queued to the JESAID writer. 

Stops the JESAID writer. SYSOUT data sets queued for the writer will be 
redirected to alternate destination or deleted if no alt-dest is specified. 

Specifies alternate destination when SYSOUT data sets cannot be transmitted 
to ASP or if the writer is stopped. 

Starts the JESAID writer. 

Activates the JESS queue dump. 

Note: When DUMP=ALL is specified, none of the other parameters can be used. 

Specifying STATUS results in message IAT19S0, indicating status of JESAID 
functions. 

Note; This may be used in combination with other parameters but only as the 
last parameter. 

Halt I/O on CTC and display most recent 16 commands from ASP over the 
CTC to JESAID. 

Display most recent 16 commands from ASP sent over the CTC to JESAID. 
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JESAID, ASPAID; ASP-JES3 Migration Aid (cont.) 


♦CANCEL 

s|e^ jJESAID 


Causes JESAID to terminate and notify ASPAID of its termination. 


♦RESTART 
♦ ,JESAID 


Reinitializes JESAID functions after an ASP or ASPAID restart. This should be 
used only when requested by ASPAID. 


♦START 


All parameters on ♦CALL command are valid. 


,U,NGT=AID 


Causes modification of the SYSOUT data queue. No other parameters are 
needed; if given, they are ignored. 


ASPAID Command: 


I ♦CALL 
1 ♦X 


,ASPAID 


♦START 

♦S 


♦RESTART 

♦R 


IfcpiCTiil 


.ORIGIN 

,ORG 


.NORMAL 

,N 


.JOBFAIL 

,J 


,SYSFAIL 

,S 


.DISPLAY 

,D 


= (origin[.origin]...) 


CLASS 

ORIGIN 

ORG 


.ASPAID 


Description: 


Initializes ASPAID and causes input service to begin selection of jobs to be 
transmitted to JES3 based on criteria specified in this command. 

Specifies the address of the CTC for communications with JES3. If CTC= is 
omitted, then jobs matching the selection parameters or requesting migration 
are queued for ASPAID processing. 

Specifies the name (1-8 characters) used to identify the JES3 system for 
communications. 


Specifies the job classes to be eligible for transmission. 


Specifies the job class groups to be eligible for transmission. 


Specifies the origin of jobs to be selected for transmission to JES3. 

Specifies the action to be taken if the job completes normally on JES3. 

Run the job in the ASP complex (if specified for DJC, jobs will default to 0). 
Schedule only the output DSPs and PURGE DSP. 

Schedule only for PURGE DSP processing in the ASP complex. 

Specifies the action to be taken if the job fails on JES3. 

Run the job in the ASP complex (if specified for DJC, jobs will default to 0). 
Schedule only the output DSPs and PURGE DSP. 

Schedule only for PURGE DSP processing in the ASP complex. 

Specifies action to be taken if JES3 fails or if ASPAID is terminated. 

Reschedule the job (valid only for the SYSFAIL= parameter). 

Run the job in the ASP complex (if specified for DJC, jobs will default to 0). 
Schedule only the output DSPs and PURGE DSP. 

Schedule only for PURGE DSP processing in the ASP complex. 


Displays classes or origins currently being used for job selection. 


All parameters on ♦CALL are valid. CTC= and NAME= cause no specific 
action, but update control blocks. 

Reinitializes CTC communications with JES3. All transmitted jobs are pro¬ 
cessed according to their SYSFAIL option. This command should be issued 
after a JES3 failure requiring that the communications be reinstated. The 
operator is prompted to start or restart JESAID. 

Terminates ASPAID functions. JESAID is notified of ASPAID termination. 
Jobs transmitted to JES3 are processed according to their SYSFAIL option. 
Jobs requesting R (rescheduling on JES3) are processed according to their 
JOHb AIL option. 
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JESNEWS DSP 




Function: The JESNEWS DSP creates, replaces, or deletes the JESNEWS data set to be printed at the specified location type with each output job. 
JESNEWS creates and maintains 3 data sets (local, RJP, TSO) that can broadcast general information to JESS users. 


Command: 


*CALL 

*X 


( LCL 
,DS={ RJP 
I TSO 


( ADD 
,TYPE={ REP 
1 DEL 


^RESTART 

*R 


,JESNEWS 


JESNEWS 


,JESNEWS,text 


Description: 

Specify the output location for the JESNEWS data set: LCL-local printers, 
RJP-remote printers, TSO-TSO users. 


Specify function to be performed on the specified data set. 

Note: Both DS= and TYPE= must he specified. There are no defaults. 

Terminates the JESNEWS DSP and no action is performed with the current 
JESNEWS data set. 

Queues the data set being affected as a result of the *X,JESNEWS command. 

Places a line of data in the JESNEWS data set being affected as a result of the 
*X,JESNEWS command; text is 1-64 characters, free form. 


DSP: M^in Se»ic^ 

Function: During main service, operator action may be required for an IPL of processors, analysis of unusual messages, intervention when 
limits are exceeded, modification of SELECT statement parameters, and intervention when abnormal operating conditions 
are observed. Use the following commands, as appropriate. 


Command: 


*START 


,CONNECT 
,R=message 


^ I OFF! 


^CANCEL I I jobname I I ,DUMP 

*C Jobno ,D 


"RESTART 


"R Jobno 


Jobname 


Description: 

Specifies formatting of OS job queue data set. Valid for ASP processors 
only. If FMT=YES is specified, all jobs in the queue must be resubmitted. 

Begins manual IPL procedure, (ASP main processors only). 

Ends manual IPL procedure (ASP main processor only). 

Removes jobs in execution from a JESS local or ASP main processor. 
Establishes connection from local to global processor. 

Simulates messages received from ASP main processor only. 

Specifics either manual or automatic IPL for ASP main processors. 


Cancels and optionally provides a dump of specified job on named processor. 


Restarts a job already in execution on the specified processor. 
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Function: MAINTASK, residing and operating in each ASP main processor, incorporates ASP/OS modifications and provides subtasks that enable 
ASP to take advantage of OS facilities. 

Command: Description: 




,ADSGEN 


,START 1 
,STOP ) 



(SL ) 

,VER,dev adr,VOL={ NL J ,vol 
\ BL ) 


,ISO 


,dev adr 1 
,ALL I 


,RESET 1 
,SET ) 


,LOCATE,dsn[,vol] 

I ,nnnK ] 

,RESET i [,T=tasknamel 
,LIST j 

[,job class] [,ONEKEY] 

,ALTH 

,SNAP 

,HOTMAIN 


Starts or stops subtask: 

A Command processor and reader/interpreter modules 

B Dynamic dispatching priorities 

C Channel-to-channel monitoring 

D TSO modules 

E AOUTPUT writer 

Starts or stops subtask creating interface to send ASP output 
to main. 

Starts or stops subtask creating interface to receive jobs from 
TSO terminal user. 


Starts or stops subtask allowing output data sets to be built 
on main OS output queue before being sent over CTC. 
AOUTPUT may specifically be sent to DSP’s print service 
and/or punch service or limited to a specific OS job class. 


Displays size of available ASP main processor storage. 

VER parameter of *MODIFY command is used to determine 
the serial number of the mounted volume. SL standard label, 
NL= nonstandard label, BL bypass label processing. 

Alters entries in unit isolation table. RESET makes setup 
devices available to OS allocation; SET makes setup devices 
unavailable to OS allocation. 

Searches catalog for location of specific data set. If volume 
serial number is omitted, system catalog is assumed; vol speci¬ 
fies volume on which desired catalog resides. 

Alters storage boundaries for a specific OS job class or task 
by creating a new entry of size nnnnK or resetting (releasing) 
a fence, or lists status of all fences and available storage areas. 
ONEKEY specifies that all jobs in tfte created fence will have 
one protect key. 

Displays OS logical track headers still available in the OS job 
queue. 

Specifies a dump of MAINTASK region. 

Specifies an independent processor to be an online real ASP 
main processor. 


*SEND 


,main,STOP MT 


Terminates MAINTASK on ASP main processor. 
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Function: The following operator commands are available to allow a job to proceed to the mount stage under manual allocation, to return a job 
to a point following volume fetch, to alter the normal environment in which MDS is operating, and to remove a job from the JESS sys¬ 
tem that is currently being processed by MDS. 


Command: 


*start1 (,setup 
*S j |,S 


*RESTART 

*R 

^CANCEL 

*C 


(jobname [ jobname]...) 

setup) 


,s 

,SETUP 


j (jobno[ jobno] ...),E 
(jobno[jobno]...) 


Description: 

Allows the named job to proceed to the allocate phase. 

Returns the named job to a point following volume fetch. E specified 
extended information at time of next MDS setup attempt. 

Removes a job currently being processed by MDS from the system. To modify 
MDS see the *MODIFY command in “JESS Operator Commands” earlier. 


NJP DSP: Network Job Processing 




Function: The network job processing (NJP) DSP handles communications among JESS systems at different locations. 
Command: Description: 


*CALL 

*X 


,NJP 


*START 
*S 

( *START 1 
|*S j 


*START 


,NJP,OPEN,LINES=0name[,lname]...) 


,NJP,SEND 


,DEST=term 

,EXEC=(scheduler element 
[,scheduler element] . , .) 
,J=jobno 


,N=nnn 

,ALL 


,NJP,RESET,DEST=term 


,P=prty, 

,NJPCLASS=cls 


Names of the scheduler elements to be executed at the remote site. 


The job, number of jobs, class of jobs, or priority level of jobs to be scheduled 
for NJP. 


,J=jobno 

,N=nnn 

,ALL 


,P=prty, 

,NJPCLASS=cls 


See preceding description. 


*START 

4 [,NJP,Q,DEST=term 


,CONSOLE=con 

,FROM=term 

,TO=term 

,P=nn 

,NJPCLASS=cls 


*CANCEL 

*C 


,NJP 

,lname 


Specifies console upon which status information is to be displayed. If omitted, 
console issuing request is used. 

Limits status information to jobs from cited location. 

Limits status information to jobs sent to cited location. 

Limits status information to jobs at specified priority level. 

Limits status to specified class. 

Cancels specific line name or terminates operator communications with NJP 
while NJP jobs are being scheduled. 


RJP DSPs: BSC RJP and SNA RJP 


BSC RJP DSP 

Function: The binary synchronous communications remote job processing (BSC RJP) DSP handles communications between JESS and 
remotely located BSC RJP work stations. 


Command: 

*call| 

*x 


j 

*START 1 
*S ) 


RJP 


,RJP,L=lname 


j ^CANCEL 

(*c 


,RJP,L= j [,1] 


‘RESTART , , , ,, 

* 1 ^ [ ,RJP,L=lname[,I] 


Description 

Activate the BSC RJP DSP. 

Start the specified BSC RJP line. 

Cancel all current activity on the specified line. 

ALL specifies termination of all lines and the BSC RJP DSP. 
I specifies immediate termination. 

Terminate the specified line and then start it again. 

I specifies immediate termination. 
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SNA RJP DSP 

Function: The systems network architecture remote job processing (SNARJP) DSP handles communications between JESS and remotely 
located SNA RJP work stations. 


Command: 


-SNARJP 

|*START| SNARJP,T=wsname . 

. rSNARJPr.T={ 

(‘CANCEL1 ) L * AL 

’ l,(dev[,dev]..,) [,J] 
/‘RESTART) 


TRACEON 

TRACEOFF 

TRACEOFF,NOPRT 


,SNARJP,T=wsname[,I] 


RJPSNPS DSP: RJP Snapshot Dumps 


Description 

Activate the SNA RJP DSP. 

Start the specified SNA RJP workstation, and optionally, start the SNA 
trace facility. 

Halt the SNA RJP network or the specified or all work stations. 

I specifies immediate termination. 

Halt the specified SNA RJP device. J specifies to cancel all data sets 
for the specified device. 

Terminate the specified work station and then start it again. 

I specifies immediate termination. 




Function: The RJP snapshot dump (RJPSNPS) DSP provides the capability to create snapshot dumps of the line device control table (DCT), 
current input/output block (lOB), and transmission data areas at channel end. This is primarily a diagnostic aid. 

Note: Output is an internal JESS spinoff output data set. The data set is queued off job 0 (J=0 on an output service *I command). 


Command: 


*CALL 

*X 


RJPSNPS ,CLASS= 


(els 

I DEBUG CLASS 


^MODIFY 

*p 


Description: 


Activates RJPSNPS and creates the data set into which snapshot output is placed. 


Activates RJPSNPS for a line or all lines. 


j‘RESTART'! ,RJPSNPS,CLASS={^|bUGCLASs} 

I :f j ,rjpsnps.class=| pebug class } 

j ‘CANCEL j ,RJPSNPS,CLASS={|gp^^} 

I *M 0 D 1 FY I I Iname | gNAPOFF 


Cancels recording of snapshot information and starts it again. 
Resumes recording of snapshot information. 

Terminates RJPSNPS. (Use after desired events have been recorded.) 

Terminate RJPSNPS for a line or all lines. 
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rc DSP: Tape-to* 


Function: The tape-to-card (TC) DSP punches 
assumed to be unlabeled tapes. 


dev 

dev adr I 
(typ[,group]) I 
([typj^roup) 


tape files into cards from 7- or 9-track tapes. No volume switching is performed on what are 


Description: 


Specifies input device by name, address, or type and/or group. If omitted 
TA9 is assumed. 


dev 

dev adr 
(typ[^roup]) 
([typ] .group) 




Specifies output device by name, address or type and/or group. If omitted 
PUN is assumed. 


Sets cancellation or rescheduling if devices are not available. The default is 
assembled in lATYDSD. 


,BLOCK=nn 


*CALL 

*X 


f C 

,MD= I T 

1 ET 


Specifics tape marks to be passed from load point (0-99). Omission causes 
no repositioning. 


Specifics tape density: 

2--200 bpi (7-track) 

5-556 bpi(7-track) 

8—800 bpi (7- or 9-track) 

16-1600 bpi (9-track) 

62-6250 bpi (9-track) 

Specifies recording mode for 7-track tape: 

C - odd parity, converter on, translater off 
T — odd parity, converter off, translator on 
ET - even parity, converter off, translator on 


♦START 

*S 


,TC 

,dev 

,dev adr 


Start the TC DSP. 


'^CANCEL 


,TC 
,dev 
,dev adr 


Cancel the TC DSP. 
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DSP: Tape Dump 


Function: The tape dump (TD) DSP permits dumping of 7- or 9-track tapes in EBCDIC or hexadecimal character sets to a printer. 


Command: 


♦START 

*S 


♦RESTART 

♦R 


♦CANCEL 

*C 


dev 

dev adr 
(typ[^roup]) 
([typ],group) 

dev 

dev adr 
(typ[^roup]) 
.([typl^group) 


,ID=nnn 


,TD 

,dev 

,dev adr 


,TD 

,dev 

,dev adr 

,TD 
,dev 
,dev adr 


,R= innnnnn 
,N=nnnnnn 

.“-I e" ) 


Description: 


Specifies input device by name, address, or type and/or group. If omitted 
TA9 is assumed. 


Specifies output device by name, address, or type and/or group. If omitted 
PRT is assumed. 


Sets cancellation or rescheduling if devices are not available. The default is as 
assembled in lATYDSD. 

Specifies external label identification 

Specifies tape density: 

2-200 bpi (7-track) 

5-556 bpi (7-track) 

8-800 bpi (7- or 9-track) 

16-1600 bpi (9-track) 

62-6250 bpi (9-track) 

Specifies recording mode: 

C - odd parity, converter on, translator off 
T - odd parity, converter off, translator on 
O - odd parity, converter off, translator off 
E - even parity, converter off, translator off 
ET - even parity, converter off, translator on 

Specifies number of files (01—99) to be skipped. If omitted, tape remains at 
current file. 

Specifies records to be skipped within current file. If omitted, tape remains at 
current record position (record 1 if file positioning specified). 

Specifies number of records to be dumped. If omitted, next EOF is delimiter. 
Specifies dump mode: H-hexadecimal, E—EBCDIC. 

Specifies print line length desired. If M=11, must be half actual length. 

Specifies whether header information is to be included in printout. 

Suspends dumping of current file to allow repositioning. 


Restart the TD DSP. 


Cancel the TD DSP. 
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TLDSP: Ta 


Function: The 


Command: 


tape label (TL) DSP writes a standard label on a 7- or 9-track tape. It also writes an end-of-file header if an unlabeled tape is desired. 


*CALL 

*X 


*START 


dev 

dev adr 
(typ[^roup]) 
([typ] ^roup) 


,NTAPE=nn 


,INCR=nnn 


,TL 

,dev 

,dev adr 


OWN=owner id 


Description: 

Specifies output device by name, address, or type and/or group. If omitted 
TA9 is assumed. 

Sets cancellation or rescheduling if devices are not available. The default is as 
assembled in lATYDSD. 

Specifies tape density: 

2—200 bpi (7-track) 

5-556 bpi (7-track) 

8-800 bpi (7- or 9-track) 

16—1600 bpi (9-track) 

62—6250 bpi (9-track) 

Specifies number of tapes to be labeled. If omitted, only one tape is labeled. 

Specifies increment to be added to serial number in labeling multiple tapes. If 
omitted, user specifies SER= parameter in *START command for each tape. 

Specifies initial serial number if INCR was specified on the call, or serial number 
for next tape. NL causes EOF mark to be written on unlabeled tape. 

Specifies owner’s name, 1-10 characters. 

Specifies if the tape is to be password protected. 


^CANCEL 

*C 


,TL 

,dev 

,dev adr 
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TP DSP: Tape-to-Prin 

Function: The tape-to-printer (TP) DSP prints files from 7- or 9-track tapes created by OS. 
Command: P” / , ”~1 Description: 


dev 

dev adr 
(typ[^roup]) 
([typ],group) , 

I dev 
dev adr 
(typ [,group]) 
([typ] .group) 


- ISI 


•“''111 

,F=form 

,CT=carr 
,T= train 
,CP= 11 i 


Specifies input device by name, address, or type and/or group. If omitted 
TA9 is assumed. 


Specifies output device by name, address, or type and/or group. If omitted 
PRT is assumed. 


Sets cancellation or rescheduling if devices are not available. The default is as 
assembled in lATYDSD. 

Specifies tape density: 

2-200 bpi (7-track) 

5-556 bpi (7-track) 

8-800 bpi (7- or 9-track) 

16-1600 bpi (9-track) 

62-6250 bpi (9-track) 

Specifies recording mode for 7-track tape: 

C - odd parity, converter on, translator off 
T - odd parity, converter off, translator on 
ET - even parity, converter off, translator on 

Specifies forms control. 

Specifies controlled skip option, primarily used if output to RJP printer to 
avoid first page eject. 

Specifies whether skip to channel 1 should occur when channel 12 is sensed. 

Specifies forms to be used on first report to be printed. Printer device entry is 
updated with this name. 

Specifies carriage tape to be used for first report. Printer device entry is 
updated with this name. 

Specifies train to be mounted prior to printing. Printer device entry is updated 
with this name. 

Specifies number of times the file is to be printed. 


,DSN=nnn, . . . n 
,V=vol 


f ^ 

,LB={ B 
S 


,R= 



lu ) 


(nnn i 

1133; 

,L= 

f nnn \ 

\ 133 f 


Initiates catalog search to obtain volume serial numbers (up to 44 characters) re¬ 
quired. Specifies volume upon which catalog search is to begin if DSN is given. 
If omitte(i, search begins on SYSRES. The fully qualified dsn must be specified. 

Specifies volume serial number of the tape to be printed. 

Specifies type of tape label: 

N - nonlabeled 
B - bypass label processing 
S - standard label 

Specifies record form: 

F - fixed length 
V - variable length 
U - undefined 

Specifies block length of data to be printed. 

Specifies record length of data to be printed. 
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f-to-Printer (com. 


Command: 


*START 

*S 


*RESTART I 
*R I 


♦CANCEL 

*C 


,TP 

,dev 

,dev adr 


,TP 

,dev 

,dev adr 


,TP 

,dev 

,dev adr 


,F=form 

,C=carr 


,P=printer name 

3-1«! 


Description: 

Indicates alteration of forms and/or carriage tape if the sign-on message indicates 
they are other than desired. 

Restarts job from beginning. 

Restarts the TP DSP to another printer. 

Skips forward or backward n blocks before restarting. 


Skips forward or backward n files before restarting. 


TTDSP: Tape-to-Tape 




Function: The tape-to-tape (TT) DSP copies 7- or 9-track tape files. 


Command: 


♦CALL 

♦X 


dev 

dev adr 
(typ[,group]) 
([typ] ^roup) 

dev 

dev adr 
(typ [.group]) 
([typ] .group) 


,DENO= 


Description: 

Specifies input device by name, address, or type and/or group. If omitted 
TA9 is assumed. 


Specifies output device by name, address, or type and/or group. If omitted 
TA9 is assumed. 


Sets cancellation or rescheduling if devices are not available. The default is as 
assembled in lATYDSD. 

Specifies external label for input tape. 


Specifies input or output tape density: 

2-200 bpi (7-track) 

'5-556 bpi (7-track) 

8-800 bpi (7- or 9-track) 

16-1600 bpi (9-track) 

62-6250 bpi (9-track) 


Specifies input or output recording mode for 7-track tape: 

C - converter on, translator off 
T - converter off, translator on 
Omitted - converter off, translator off 

Tape is read initially in even parity if T is specified, odd otherwise. If unsuccess¬ 
ful, parities of both tapes are reversed. 


Specifies, for input (TMI) or output (TMO), number of tape marks to be skipped 
from load point or to be backspaced. If omitted, no repositioning occurs. 


Specifies number of files to be copied. 
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TTDSP: Tape- 


ape (cont) 






♦START 

*S 




WTR DSP: Output Service Writer 


Function: Operator commands are required to invoke hot writers and to respond to mount or error messages. They may be used to change writer 
options, restart a data set or job, cancel a data set or job, change data set selection characteristics, or terminate the writer. In general, 
commands and parameters apply to print, punch, and TSO writers. Any device type specific parameters are noted. Parameters that 
apply only to the IBM 3800 Printing Subsystem writer for the *CALL, *START, and *RESTART commands are described separately 
after the *START command. 


Command; 


♦CALL 


,WTR 


,OUT= 


,NAV= 


,H= 


dev adr 

dev 

main 

(typ [.group]) 
([typ] .group) 


,B= 



,SZ=(xx,yy) 


I (vaIC.val)...) 
(/val[,/vai]...) 


.WC=(cls[.cls]. . .) 
.D 


Description: 

Specifies writer operation mode (M—manual, A—automatic). If M is specified, 
the opera^tor must issue ♦Sjdev for each data set. 

Specifies output device address, name, or type and/or group. If omitted, PRT 
is assumed. 


Specifies option if requested device is not available (C—cancel, R-reschedule). 


Specifies data set header option. 

Specifies job burst page option. 

Note: If H= or B= are omitted, DEVICE statement parameters are used. 
Specifies the maximum or minimum number of lines per data set for processing. 


Specifies forms, UCS, and carriage (FCB) names to be mounted and whether 
they are changeable (R) or held (H). 

Specifies that the number of pages in a SNA chain be set to xx and the 
number of lines per page be set to 44. 

Specifies the writer data set selection characteristics and order of importance. 
Specified values overlay the order specified in the OUTSERV statement. Values 
prefixed with / are ignored. Values omitted and not removed by use of the / 
indicator are picked up in their order of specification on the OUTSERV ^state¬ 
ment during initialization. The specified value may be: P-priority, D-destina- 
tion, T-type, F-forms, C—carriage or FCB, U—UCS (train), CL—class, L-line 
limit. 

Specifies the SYSOUT classes to be selected. 


Specifies that the diagnostic made is to be set. 


/*CANCEL I 

) 


( ,dev \ 
< ,dev adr > 
( ,J=jobno J 



The ♦CANCEL command with device name or address cancels the currently 
active data set. The J parameter cancels the currently active job; T causes the 
writer to terminate upon completion of the current request. 


♦INQUIRY 


See the ♦INQUIRY command in “JESS Operator Commands” earlier. 
See the ♦MODIFY command in “JESS Operator Commands” earlier. 


♦MODIFY 










JES3 FUNCTIONS 


WTR DSP: Output Service Writer (cont.) 




,M 

,A 

/ C \ 

G 

J 

N 

[Ll } 


,s 

,p 


*RESTARTlf’^®^ ^ 
H,devadr 

I ,J=jobno 


’HHn 


,B= 


R_ n[Pl 


,D= 


dev 

dev adr 


nnn 

,CP= { +nnn 
-nnn 



nam 

STANDARD 



,SZ=(xx,yy) 


,WS^ 


^ f (val[,val]...) 
(/val[,/val] „.) 


,WC=(cls[,cls]...) 

,RSCD 


Sets manual mode (not valid for TSO) or sets automatic mode. 


C — restarts current data set at last checkpoint (1000 records). 

G — Specifies to reprint all data sets processed by the restarted device for the 
current job. 

J — reprocesses all data sets of current job. 

N — restarts current data set at previous note point (100-200 lines/records) 
(not valid for TSO). 


Reloads FCB and UCS/CHARS buffer. Restart printing based upon 
other parameters. 


Specifies printing will resume in single space at beginning of data set (printers 
only). 

Specifies that the approximate number of records remaining to be written for 
the current data set be displayed. 

Sets data set header option (not valid for TSO). 


Sets job burst page option (not valid for TSO). 

Repositions current data set forward or backward n lines or pages (P). If 
specified as the only parameter, then it repositions from beginning of data set. 

If specified with C or N, it repositions from checkpoint or note. 

Specifies new device on which current and subsequent data sets are to be pro¬ 
cessed. 

Specifies copy count of current data set is to be replaced, increased, or decreased 
by nnn. 

Specifies current data set is to be placed in HOLD for later processing. 

Specifies that writer terminate on completion of current request. 

Specifies forms, UCS, and carriage (FCB) names to be mounted and whether 
they arc changeable (R) or held (H). These parameters should be used in 
response to messages IAT7005, IAT7006, or IAT7030. 

Specifies that the number of pages in a SNA chain be set to xx and the 
number of lines per page be set to yy. 

Specifies the writer data set selection characteristics and order of importance. 
Specified values overlay the order specified in the OUTSERV statement. Values 
prefixed with / are ignored. Values omitted and not removed by use of the / 
indicator are picked up in their order of specification on the OUTSERV state¬ 
ment during initialization. The specified value may be: P—priority, D—destina¬ 
tion, T-type, F-forms, C—carriage or FCB, U—UCS (train), CL—class, L—line 
limit. 

Specifies the SYSOUT classes to be selected. 

Specifies that the writer is to perform a scheduling pass. This parameter 
usually is used in the command *R,name,C,T,RSCD. 




JES3 FUNCTIONS 


WTR DSP: Output Service Writer (cont'd) 


Command: 


,M 

,A 

,S 

,P 


Description: 

Specifies writer operation mode (M-manual, not valid for TSO; A-automatic). 
If M is specified, the operator must issue *S,dev for each data set. 

Specifies single-space printing for remainder of data set (valid for printers only). 

Specifies that the approximate number of records remaining to be written for 
the current data set be displayed. 


,T 



Specifies that writer is to terminate upon completion of current request. 
Specifies data set header option. 


.L=ir,4 


*STAR'I \ 
*S I 


,dev 

,dev adr 
,J=jobno 



( nnn ) 
+nnn i 
-nnn j 


( ] 

I nam ] 


={ STANDARD 1 

i ,CTj 

1 [nam] 

,SZ=( 

XX,yy) 


,WS= 


(val[,val]...) 1 

(/val[,/val]...) I 


,WC=(cls|,cls]...) 


Specifics the maximum or minimum number of lines per data set for processing. 
Specifies job burst page option. 

Note: If 11= or B= are omitted, DEVICE statement parameters are used. 
Repositions from current position in data set. 


Alters the copy count of currently active data set. 


Specifies forms, UCS, and carriage (FCB) names to be mounted and whether 
I hey are changeable (R) or held (H). These parameters should be used in response 
to message 1AT7030. 

Specifies that the number of pages in a SNA chain be set to xx and the 
number of lines per page be set to yy. 

Specifies the writer data set selection characteristics and order of importance. 
Specified values overlay the order specified in the OUTSERV statement. Values 
inefixed with / are ignored. Values omitted and not removed by use of the / 
indicated are picked up in their order of specification on the OUTSERV state¬ 
ment during initialization. The specified value may be: P—priority, D-destina- 
tion, T type, F-forms, C-carriage or FCB, U-UCS (train), CL-class, L-line 
limit 

Specifies the SYSOUT classes to be selected. 


Note: The CH=, FL=, CM=, and SS= parameters apply only to the IBM 3800 
*CALL, * RESTART, *START Printing Subsystem writer. They specify reassignment of the 3800 writer char- 

3800 Printing Subsystem Parameters in tcristics. These may be used with other appropriate parameters for the 

(oinmands. 


,CH^ 


,FL= 


I tab[,tab). . . 


overlay | 


NONE 


,CM=j([' 


module!,trc 


NONE 


I c I [l ,H 1 

■SS-(s } h.R j 



WS=|(va’[.vall... 
I (/val[,/val] 


.) 


,( B= 


D 

J 


Specifies the reassigned character arrangement tables. No more than four table 
names can be specified. H specifies that this character arrangement table is to 
he used until you change it. R specifies JES3 may request a different table. 

Specifies the reassigned forms overlay frame. H specifies that only the designated 
l«n m is to be used on this device until you change this status. R specifies that 
Jl S3 may request that a different form be placed on this device. NONE specifies 
I ha I no forms overlay frame is designated for this writer. 

S|H‘cifies the reassigned copy modification module, tre specifies the table refer- 
I’ticc Character (0, 1, 2, 3). H specifies that only the designated copy modification 
module is to be used on this device until you change this status. R specifies that 
.11 S3 may request that a different copy modification module be placed on this 
ilcvice. NONE specifies no copy modification module is designated for this writer. 

StH'cifies the stacker select option. C specifies continuous fanfold. S specifies 
I'l inted output is to be burst into separate sheets. 

.Avldi/ional WS=(val, . . . ) parameters are: 

I I forms FLASH 

CM copy modifier 

SS I — stacker selection 

CH |- character images (analogous to TRAIN/UCS) 

Specifies whether clear print burst processing is to be performed after each data 
set (ib) or at the end of the job (J). 



